home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / geos / non-GEOS / geoRAM wedge.readme < prev    next >
Encoding:
Text File  |  1998-01-11  |  2.1 KB  |  75 lines
  1. file: GEORAM WEDGE                     from: cRAFTWARE   08/09/90   s#: 788676        
  2. subject: georam sTASH/fETCH/sWAP *
  3.  
  4. type:          PRG
  5. blocks:        2
  6. downloads:     2
  7. est. d/l time: 300: 00:27 1200: 00:08 
  8. equipment:     c128, geo-ram CARTRIDGE
  9. files needed:  NONE
  10. author:        cRAFTWARE
  11. shareware:     NO
  12.  
  13. subj -- fetch,stash,swap USING GEOram
  14. tHIS WEDGE ALTERS THE bASIC 7.0 reu
  15. COMMANDS (fetch, stash, AND swap) TO
  16. WORK WITH A GEOram reu INSTEAD OF A
  17. cOMMODORE TYPE UNIT.
  18.  
  19. tO INSTALL:
  20.   bank0:bload"georam wedge"
  21.   sys dec("0c00")
  22. nOTES:
  23.  -c128 ram bANK 0 OR 1 IS SUPPORTED;
  24.   THE bank COMMAND DETERMINES WHICH ram
  25.   bank WILL BE USED.
  26.  -fast IS ALLOWED -- EVEN recommended!
  27.   bECAUSE GEOram ACCESS IS SLOWER SINCE
  28.   IT DOESN'T USE dIRECT mEMORY aCCESS.
  29.  -illegal quantity ERROR WILL OCCUR IF
  30.   THE EXPANSION BANK IS GREATER THAN 7.
  31.  -nUMBER OF BYTES IS REALLY 0 TO 65535,
  32.   BUT 0 WILL TRANSFER 65536 BYTES.
  33.  -tHE WEDGE WILL PIGGYBACK WITH ANOTHER
  34.   WEDGE WHEN INSTALLED (I.E. IT WILL
  35.   LOOK FOR A WEDGED jmp IN THE chrget
  36.   ROUTINE AND WILL jmp THERE INSTEAD
  37.   OF RETURNING TO chrget WHEN PASSING
  38.   NON-WEDGE TOKENS.)
  39.  
  40.   rESIDES IN $0c00 TO $0d24 AND USES
  41.   $fe AND $ff FOR ZERO PAGE POINTER.
  42.   tO MODIFY THESE LOCATIONS, ml SOURCE
  43.   IS UPLOADED AS FILE GEOWEDGE.S WHICH
  44.   IS A merlin SOURCE FILE.  fULL DETAIL
  45.   OF WEDGE ARE CONTAINED IN COMMENTS.
  46.   aLSO INCLUDES ml CALLABLE ROUTINE TO
  47.   PERFORM OPERATIONS FROM ml PROGRAMS.
  48.  
  49. eXAMPLE:
  50.   sAVE THE BIT-MAPPED GRAPHICS AREA,
  51.   WHICH IS 9k FROM $1c00 TO $4000 INTO
  52.   START OF EXPANSION MEMORY:
  53.  
  54.   fast:bank0
  55.   stash dec("2400"),dec("1c00"),0,0
  56.   rem   >#bytes=9k  >start addr
  57.  
  58. tIMING:
  59.  8k TRANSFERS:
  60.    stash=0.88 SEC slow / 0.43 SEC fast
  61.    fetch=0.85 SEC slow / 0.42 SEC fast
  62.    swap =1.32 SEC slow / 0.65 SEC fast
  63.  128k (2 stashES OF 64k)
  64.    stash=14.1 SEC slow / 6.90 SEC fast
  65.  
  66. cAVEAT:
  67.   iF ram ADDRESS + #BYTES OVERFLOWS
  68. 65525 IT WILL WRAP TO 0 IN SAME BANK.
  69. eXPANSION WILL ONLY OVERFLOW FROM BANK
  70. 7 INTO BANK 0.
  71.   oF COURSE, YOU WOULD CRASH YOUR
  72. SYSTEM IF YOU fetchED OVER SENSITIVE
  73. AREAS, SUCH AS THE WEDGE ITSELF, ram
  74. BELOW $0400, OR $ff00-$ff05.
  75.